home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / dskut / qic02_11.zip / README < prev    next >
Text File  |  1993-05-27  |  5KB  |  144 lines
  1. QIC02 device driver for MSDOS, version 1.1, released May 1993
  2. Author: Eddy Olk, eddy@duteca.et.tudelft.nl
  3.  
  4.  
  5. Abstract
  6. ========
  7.  
  8. This package contains my DOS device driver and magnetic tape
  9. manipulation program for the Archive SC402/SC499R tapestreamer
  10. interface cards having the QIC02 command set. I don't have
  11. documentation on other brand QIC02 interface cards but I don't expect
  12. them to work with this driver.  The driver should work on MSDOS 3.3,
  13. MSDOS 5.0, DRDOS 6.0, and OS/2 (DOS box).
  14.  
  15.  
  16. Package contents
  17. ================
  18.  
  19. The package should have the following files:
  20.  
  21.        README     - this file describing installation etc.
  22.        QIC02.SYS  - the device driver
  23.        MT.COM     - magnetic tape manipulating program
  24.        MT.DOC     - document file for mt program
  25.  
  26.        COPYING    - GNU General Public License
  27.  
  28.        QIC02.C    - device driver source code
  29.        QIC02.H    - header file for qic02 driver
  30.        TCDEV.ASM  - some magic assembler stuff,
  31.        TCDEV.OBJ  - already assembled...
  32.                     (Note: this one differs from the original object file)
  33.        MT.C       - magnetic tape manipulation program source code
  34.        MTIO.H     - header file for mt
  35.        MAKEFILE   - makefile (for TurboC)
  36.  
  37.  
  38. Software status
  39. ===============
  40.  
  41. This program is free software; you can redistribute it and/or modify
  42. it under the terms of the GNU General Public License as published by
  43. the Free Software Foundation; either version 2 of the License, or (at
  44. your option) any later version.
  45.  
  46. This program is distributed in the hope that it will be useful, but
  47. WITHOUT ANY WARRANTY; without even the implied warranty of
  48. MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  49. General Public License for more details.
  50.  
  51. You should have received a copy of the GNU General Public License
  52. along with this library; if not, write to the Free Software
  53. Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
  54.  
  55.  
  56. Package details and usage
  57. =========================
  58.  
  59. The device driver installs itself as a DOS character device named
  60. TAPE$. Usually the tar program will be used to read/write tapes with
  61. the TAPE$ device. Also other programs can be used (I don't know any
  62. however) as long as they read/write data in multiples of 512 bytes,
  63. the size of a block on tape.
  64.  
  65. This last requirement revealed a subtle difference between MSDOS and
  66. DRDOS since several TAR programs working fine with DRDOS did not work
  67. with MSDOS as the driver did not got requests for multiple 512 byte
  68. transfers. However, the gnutar for OS/2 seems to work fine with OS/2,
  69. MSDOS, as well as DRDOS. So this tar is probably the best thing to
  70. use. Here are some FTP sites where you can find this gnutar:
  71.  
  72.    dutepp0.et.tudelft.nl:/pub/Os2/gnutar.zoo
  73.    ipc1.rrzn.uni-hannover.de:/pub/os2/gnu/gnutar.zoo
  74.    iskut.ucs.ubc.ca:/pub/os2/shadow/all/unix/gnu/gnutar.zip
  75.    luga.latrobe.edu.au:/pub/os2/all/unix/gnu/gnutar.zip
  76.    rusmv1.rus.uni-stuttgart.de:/pub/soft/os2/Arc/ArcProgs/gnutar.zip
  77.    src.doc.ic.ac.uk:/computing/systems/os2/all/unix/gnu/gnutar.zip
  78.    sun.rz.tu-clausthal.de:/pub/os2/archiv/gnutar.zip
  79.    swdsrv.edvz.univie.ac.at:/os2/hobbes/all/unix/gnu/gnutar.zip
  80.    van-bc.wimsey.bc.ca:/pub/os2/archivers/gnutar.zoo
  81.  
  82.  
  83. Installation instructions
  84. =========================
  85.  
  86. Installing/using the device driver and accompanying `mt' magnetic tape
  87. manipulation program is pretty straightforward. (See the mt.doc file
  88. for details on how to use mt.)
  89.  
  90. 1. Copy QIC02.SYS to the root directory of your booting disk and copy
  91.    MT.COM to a directory which is part of your path.
  92. 2. Put the line:
  93.  
  94.        DEVICE=QIC02.SYS 220 3 7
  95.  
  96.    in your CONFIG.SYS. The first parameter indicates the SC402/499
  97.    board's configured base I/O address (here 220h), the second parameter
  98.    indicates the DMA channel (either 1 or 3, here 3). The last
  99.    parameter indicates the interrupt number but the current driver
  100.    version simply skips it since no interrupts are used (yet).
  101.  
  102. This completes the installation for the QIC02 tape device driver.
  103. However, you may want to put the line:
  104.  
  105.        SET TAPE=TAPE$
  106.  
  107. in your AUTOEXEC.BAT so that gnutar automatically uses the tape drive
  108. without specifying it specifically with the -f option. E.g. to write the
  109. current directory to tape with tar you can then simply use "tar c ."
  110. instead of "tar cf TAPE$ .".
  111.  
  112.  
  113. Sources
  114. =======
  115.  
  116. The accompanied sources are compiled with the Turbo C compiler from
  117. Borland but I don't expect compiling with other C compilers to give
  118. significant problems, if any at all. For the device driver I
  119. gratefully used some source from H.H. Bergman's QIC02 device driver
  120. for Linux, Doug Braun's SCSI driver (SCSIDRVR.ARC) and the TCDEV.ARC
  121. archive.  The mt program is based on source from the University of
  122. California at Berkeley.
  123.  
  124.  
  125. Bugs
  126. ====
  127.  
  128. I'm not aware of any bugs in the device driver or the mt program but
  129. this doesn't mean there aren't any!! If you have found a bug (or fixed
  130. one :-), suggestions for improvements, or any problems with the
  131. driver, please contact me. You can contact me via email (preferred)
  132. or normal mail:
  133.  
  134. email: eddy@duteca.et.tudelft.nl
  135.  
  136.  mail: Eddy Olk
  137.        Beatrixstraat 8
  138.        3264 XB  Nieuw-Beyerland
  139.        The Netherlands
  140.  
  141.  
  142. Enjoy!
  143.  
  144.